home *** CD-ROM | disk | FTP | other *** search
/ Acorn User: The RISC OS Graphics CD / Acorn User: The RISC OS Graphics CD.iso / utilities / vrml / _vrml / _help next >
Encoding:
Text File  |  1997-04-30  |  5.6 KB  |  163 lines
  1.               Help file for the VRML Converter (BETA VERSION)
  2.  
  3.                             By Duncan McPherson
  4.  
  5.                        30th of April 1997 (0.1 Beta)
  6.  
  7.            * YOU MUST LET THE FILER 'SEE' !Euclid BEFORE RUNNING *
  8.  
  9.  
  10. What is it and how do I use it
  11. ------------------------------
  12.  
  13. This program converts VRML files into !Euclid files. Once this is done you
  14. can edit the VRML files in the Euclid editor, and make animated films from
  15. them using !Mogul. I do not have a copy of !ArcLight, but I assume that they
  16. can be raytraced too.
  17.  
  18. VRML files use floating point aritmetic. Euclid files dont. In order to get
  19. round this problem the user must specify a 'scale factor'. The only way to
  20. do this at the moment is by trial and error. Too large a scale factor, and
  21. you will not see anything. Too small and the object will become an
  22. indistinguishable blob.
  23.  
  24. Once you have your VRML file loaded and converted, use the <select> mouse
  25. button to rotate, and <adjust> to scale the object. For more control you
  26. should save the file by pressing <menu>, and load it into !Euclid for
  27. viewing with a camera.
  28.  
  29.  
  30. Whats VRML Then?
  31. ----------------                              
  32.  
  33. VRML is the most exciting thing to hit the internet since the world wide
  34. web. In its first version (VRML 1.0) it allows virtual worlds to be used in
  35. much the same way as web pages. You can click on virtual objects (just like
  36. HTML links) which take you into other worlds, read text, walk around and do
  37. most 'webby' things except in three dimensions. VRML 1.0 is not interactive
  38. though, and nothing in the worlds can move around.
  39.  
  40. VRML 2.0 expands on this, allowing objects to be animated and the user to
  41. interact with the world in very sophisticated ways. With a suitable VRML 2.0
  42. browser you can create entire interactive worlds. 'Behaviours' can be
  43. attached to objects by means of a script language (Java/JavaScript e.t.c.),
  44. and the browsers allow for all manner of 'sensors' in a world to make things
  45. happen.
  46.  
  47.  
  48. This beta version
  49. -----------------
  50.  
  51. !VRML allows you to convert VRML files into the Euclid file format. The
  52. program is under development on three fronts at present :
  53.  
  54.  i) A completely new version of the Euclid module is being written.  This
  55.     will interface to the old Euclid editor, and also optionally pass
  56.     rendering commands to topmodels Gemini rendering engine (though it will
  57.     be a little slower when doing this). The module will support all current
  58.     euclid object types along with the complete VRML 2.0 node set. Support
  59.     for ACE films and animation will be through the origional Euclid module.
  60.  
  61. ii) All basic code to be converted into C, and linked to AOF versions of
  62.     the ARM code sections of the programs.
  63.  
  64. iii) VRML parser code to fully cope with VRML 2.0 object nodes, and VRML
  65.     2.0 conventions. A full VRML2.0 parsing system will be implimented along
  66.     with work to re-write the Euclid module.
  67.  
  68. Other long term goals (under consideration at present) are to interface
  69. script nodes to 'chockino', a java bytecode interpreter for RiscOS. I am
  70. also considering the possibility of a new script type 'armcode' which would
  71. allow vrml worlds to be animated very quickly.
  72.  
  73.  
  74. Known Problems
  75. --------------
  76.  
  77. VRML exported from DaVinci dosent appear to heed the VRML 1.0 standard. Any
  78. files generated by this must be slightly altered. In particular DaVinci's
  79. info nodes dont appear to have the field name 'string' before an info string:
  80.  
  81.                 Info { string "<info here>" }
  82.  
  83. Also VRML is case sensitive, and DaVinci outputs one of the colour node
  84. field names in the wrong case (specularColor I think). This can be cured by
  85. putting the VRML file through a search and replace in a text editor.
  86.  
  87. Before release the BASIC code used was crunched. This may have introduced
  88. bugs that I am unaware of - please report.
  89.  
  90.  
  91. Nodes not implimented / partially implimented
  92. ---------------------------------------------
  93.  
  94. 1) LOD nodes are interpreted as groups. This means that different levels of
  95.    detail are 'amalgamated' into one (can be messy). In the euclid file, any
  96.    LOD nodes are named 'lod', and at present you must delete any unwanted
  97.    levels of detail in the Euclid editor
  98.  
  99. 2) Transformations are not implimented yet.
  100.  
  101. 3) Indexed material/colour bindings are not implimented
  102.  
  103. 4) Textures are ignored (Eudlid cannot render textures but supports them in
  104.    it's file format)
  105.  
  106. 5) Indexed line sets are ignored (euclid cannot mix wireframe & solid)
  107.  
  108. 6) No support currently exists for prototyping VRML 1.0 nodes using the
  109.    'isa', or 'fields' directive. Support will be made for VRML2.0
  110.    prototyping facilities.
  111.  
  112. 7) Text nodes are currently ignored.
  113.  
  114. 8) I'm sure there are more ...
  115.  
  116.  
  117. Possible additions
  118. ------------------
  119.  
  120. If there is demand, I am willing to write a collection of routines to output
  121. VRML 1.0/2.0 files from Euclid files. It may also be possible to generate
  122. animated VRML 2.0 worlds using Mogul, however I do not at present have
  123. access to any file formats for this program.
  124.  
  125.  
  126. Licence
  127. -------
  128.  
  129. This beta version of !VRML is freeware.  By this I mean that it may be
  130. freely distributed as long as the application is complete (including this
  131. help file) and nothing is modified.
  132.  
  133. You are asked (very nicely) to report bugs, and give me lots of
  134. suggestions/encouragement with future versions of the program.
  135.  
  136.  
  137. Contacting Me
  138. -------------
  139.  
  140. Email : dfm@st-andrews.ac.uk
  141.         dfm@dcs.st-andrews.ac.uk
  142.         http://www-2nd-cs.dcs.st-andrews.ac.uk/dfm/home.html
  143.  
  144. Until End of May 1997 :
  145.  
  146.   Duncan McPherson
  147.   Room 46
  148.   Scott Block
  149.   David Russell Hall
  150.   Buchanan Gardens
  151.   St-Andrews
  152.   KY16 9LY
  153.  
  154. Home address :
  155.  
  156.   Duncan McPherson
  157.   72 Hilton Street
  158.   Aberdeen
  159.   AB24 4QS
  160.  
  161. Have fun with VRML!
  162.  
  163.